Configuring or editing AMI Readings Import settings

ARI settings define how IEE imports the read jobs from Itron OpenWay and processes the information. Use the following procedure to configure IEE system ARI properties.

  1. In IEE, select System Administration > System Admin > System Settings.

  2. From the Section dropdown list, select AMI Readings Import.

  3. Click on a row to highlight and edit the following settings.

    ARI Enabled

    Determines whether IEE uses the database importer for ARI. Select True to enable or False to disable it.

    If you need to shut down the application server, set ARI Enabled to False before you shut down the computer. Return the value to True after you restart.

    Note: Selecting True enables the HVRI_IMPORT job in the database. If someone manually disables the HVRI_IMPORT job in the database, this value may still show True, but the job will not run. If IEE is not processing clean reading files (for example, the files remain in state 0), verify that this system setting is set to True and that the HVRI_IMPORT job is enabled in the database.

    Binary File Days to Keep

    Defines the number of days to keep completed work bin and binary files. Enter a whole number.

    Critical Change Evaluation to Include Midnight Changes

    Determines whether critical changes that occur exactly at midnight trigger the routing of all readings for that day to the XML Reading Import adapter (Workbin 0). Examples of critical changes include the creation of a new effective dated version of a meter, or an effective dated interval length change on a meter channel. The default value is False. Select True to enable this parameter.

    Current Day

    Defines the import day for the ARI process. By default, this field is empty, indicating the true current day. The default behavior uses the current day, which is the day prior to the processing day. You can enter a date in this field for testing or benchmarking purposes. Use the dropdown arrow to select a test date from the calendar. After testing, reset the field to blank.

    Maximum Files in WorkBin Folder

    Defines the maximum number of files allowed in a work bin folder. This setting prevents IEE from reaching file system limits on the number of files allowed in a folder. When the number of files reaches this value, AMI Readings Import (ARI) creates a new folder. New directories are created within the Workbin directory, with a naming convention of [WB#]_[incrementing_seq#]. Valid values are whole numbers. Enter a value of 30,000 or lower.

    Maximum Finalization in Minutes

    Defines the maximum allowable time, in minutes, for an AMI Readings Import VE runner to stay running after the data collection window (DCW) closes. The finalization time must be within the same calendar day as the DCW it follows. The VE service terminates any current day VE runners that are still running after midnight. The default value is 120 minutes. Enter a whole number.

    Note: You can change this value manually during finalization if it looks like the time is running out.

    Maximum Threads

    Defines the maximum number of threads for the AMI Readings Importer to use during the database import. One thread per core on the database server is appropriate. For example, if you have 8 dual cores, enter up to 16. Entering a higher number will not increase the number of reading files that are picked up.

    Do not set this parameter to 1. This database import is designed and tested as a multi-threaded process.

      Note:

    • For SQL Server implementations, one AMI Readings Importer job must be scheduled for each thread.

    • For Oracle implementations, set the Oracle database initialization file parameter JOB_QUEUE_PROCESSES to at least this System Setting +1.

    Process Historic Days from Newest to Oldest

    Determines if the AMI Reading Import processes the most recent read files first. Select True to process the files from newest to oldest. Select False to disable this parameter.

    This setting can be used to facilitate more timely processing of the recent data in preference to older, historical data, possibly to support web presentment or other downstream requirements. The default is false because selecting true could have implications to historical estimations.

    Work Bin File Path

    Defines the path to the directory where the work bin files are located. This directory must be created in Windows before this parameter can take effect. The directory must be readable and writable from all receiver and VE servers. Enter a valid directory path in UNC format. For instance, \\server_name\AMI\WorkBins.

  4. Click Save.

Related topics: